home *** CD-ROM | disk | FTP | other *** search
/ Joystick Magazine 1995 July & August / cd No4 joystick No62.iso / mac / pc / EMULATOR / CPMZ80 / READ.ME < prev    next >
Text File  |  1992-01-14  |  7KB  |  196 lines
  1.  
  2. ZSIM is copyrighted
  3.  
  4. (c) 1990,1991 by
  5.  
  6. Version 1.2
  7.  
  8. JÅrgen Weber
  9. Wiesentalstr. 1
  10. W-7170 SchwÑbisch Hall
  11. Federal Republik of Germany
  12.  
  13. Free for personal use
  14.  
  15. Send comments to weberj@dia.informatik.uni-stuttgart.de
  16. This email addres is valid at least until Feb. 92.
  17.  
  18.  
  19. ZSIM is a Program that simulates a CP/M Z80 machine. It DOES NOT
  20. simulate CP/M. But in the ZSIM package are included a PD CP/M
  21. compatible operating system and a program to format CP/M disks, so you
  22. can run CP/M programs.
  23.  
  24. WARNING: Don't let CP/M work on an MS-Dos disc as it may be destroyed.
  25. WARNING: Even CP/M discs may be destroyed if they are in a format ZSIM
  26. WARNING: does not recognize.
  27.  
  28.  
  29. Use the software at your own risc. There is no warranty for the
  30. program of any kind. The author takes no responsibility for any damage
  31. caused by the program, either direct or indirect, to your hardware or
  32. software. If you can't accept this restriction, please don't use ZSIM.
  33.  
  34.  
  35. ZSIM consists of a Z80 emulator part and a CP/M 80 bios for 80x86 PC
  36. compatible machines. The sources of the bios are included. I think
  37. contrary to the CP/M bios a Z80 simulator might be used commercially
  38. still today, so I don't include it's sources. The Z80 emulator is
  39. contained in object form in Z80EMU.OBJ, a version with only the 8080
  40. part of it in 8080EMU.OBJ. The 8080 Version is a few per cent faster,
  41. as it hastn't to look after Z80 intricacies especially the V-Flag.
  42. Don't try to disassemble it, in programming it I vastly used macros,
  43. so the disassembler doesn't show much. But you can buy the sources of
  44. the simulator from me. Anyway I don't think the emulator code can be
  45. improved (show off, show off). Try your skills with the bios.
  46.  
  47. ZSIM was developed using Borland's TASM/TLINK.
  48. ZSIM is almost wholly written in assembler, only the popup windows and
  49. the parameter editor are written in Modula-2 (using the shareware
  50. FMODULA2 Modula).
  51.  
  52. In the sources variable and label names are in English, comments are
  53. in German. So if you are interested in some intricacies of the
  54. bios get a German-English dictionary. Sorry.
  55. By the way, excuse my English.
  56.  
  57. You may use the program ZSIM free of charge. This software may only be
  58. duplicated and used for personal, non-commercial use. The software may
  59. not be sold for profit. You may modify and improve those parts of the
  60. program where the sources are included. But the executable program
  61. must show my copyright message and a message that it has been
  62. modified. Please include notes of your changes.
  63.  
  64. You may freely copy, distribute and use this program. If you like
  65. ZSIM, a donation of $10 or any amount would be appreciated. Please
  66. send a bill to the above address.
  67.  
  68. You want the sources of the Z80 Emulator, send a 50$ check to the
  69. above address.
  70.  
  71.  
  72. ================
  73. GETTING STARTED:
  74. ================
  75.  
  76. If you don't have a CP/M disc at hand you can test the Z80 emulator
  77. anyway. Copy the files in the archive into a directory on your hard
  78. disk. Format a 360K disc with CPMFRM.EXE. Type CPMFRM to get help. Be
  79. sure that FORMAT.COM is in your PATH. The disc is only needed because
  80. ZSIM requires a CP/M disc in the drive but it may be empty.
  81. Then start ZSIM. It will load a CP/M compatible operating system from
  82. CPMSYS.CPM (Superdos together with ZCPR) and if your PC has enough
  83. memory (that is if CHKDSK shows at least 512000 free bytes) ZSIM loads
  84. RAMDISC.CPM as ramdisc. If you want to boot from a real CP/M system
  85. disc see in ZSIM.DOC for how to proceed.
  86.  
  87.  
  88. =================
  89. A SAMPLE SESSION:
  90. =================
  91.  
  92.  
  93. jgw 64K cp/m 80 bios ver 1.2 --  12/01/92  (C) 1990,1992 by JÅrgen G. Weber
  94. BDOS: SUPERDOS AND ZCPR1
  95.  
  96. A>dir
  97. NO FILE
  98. A>
  99. A>b:
  100. B>dir
  101. ARGS    .C    :  ARGS    .DOC  :  ARGS    .H    :  ARGS    .OBJ
  102. C80V    .C    :  C80V-2  .C    :  CC      .COM  :  CC      .DOC
  103. CLIBV   .OBJ  :  CONVERT .COM  :  FLOAT   .C    :  FLOAT   .DOC
  104. FLOAT   .H    :  FLOAT   .OBJ  :  IOLIB   .C    :  IOLIB   .DOC
  105. IOLIB   .H    :  IOLIB   .OBJ  :  MAPTOSYM.BAS  :  MS2CPM  .C
  106. PRINTF  .DOC  :  PRINTF1 .C    :  PRINTF1 .H    :  PRINTF1 .OBJ
  107. PRINTF2 .C    :  PRINTF2 .H    :  PRINTF2 .OBJ  :  PROFILE .ASM
  108. PROFILE .DOC  :  PROFILE .H    :  PROFILE .OBJ  :  TEST    .C
  109. TRANSCEN.C    :  TRANSCEN.DOC  :  TRANSCEN.H    :  TRANSCEN.OBJ
  110. VDE     .COM  :  ZLINK   .COM  :  ZLINK   .DOC  :  ZMAC    .COM
  111. ZMAC    .DOC  :  ZMON    .COM  :  PPIP    .COM
  112. B>
  113. B>era c80*.c
  114. B>cc ms2cpm
  115. * * *  Small-C  V1.2  * * *
  116.        By Ron Cain  and  James Van Zandt
  117.      2 August 1984
  118. MS2CPM.C
  119. #include iolib.h
  120. #end include
  121. #include args.h
  122. #end include
  123. #include printf1.h
  124. #end include
  125. ====== ms_getb()
  126. ====== main()
  127. There were 0 errors in compilation.
  128.  
  129. B>zmac ms2cpm=ms2cpm
  130. SSD RELOCATING   (AND EVENTUALLY MACRO)  Z80 ASSEMBLER VER 1.07
  131.     0  ERRORS
  132.  
  133. B>zlink ms2cpm=ms2cpm,iolib,args,printf1
  134. SSD LINKAGE EDITOR VERSION 1.4
  135.       0 UNDEFINED SYMBOL(S).
  136.  
  137. B>dir ms2cpm.com
  138. MS2CPM  .COM
  139. B>ppip a:=ms2cpm.com
  140. COPYING:
  141. B0:MS2CPM  .COM to A0:MS2CPM  .COM
  142.  
  143. B>
  144.  
  145.  
  146.  
  147. =====================
  148. FILES IN THE ARCHIVE:
  149. =====================
  150.  
  151.  
  152. The following files should be in the archive:
  153.  
  154. MAKEFILE           996 12.01.92   18:03     | ZSIM's makefile
  155. CONIO    ASM     21993 09.01.92   22:02     | sources
  156. PORTIO   ASM      1200 11.12.91   20:00     | sources
  157. CPMBIOS  ASM     73436 12.01.92   16:53     | sources
  158. DOS      INC      6479 20.05.90   13:30     | sources
  159. Z80EMU   INC       678 11.12.91   18:13     | sources
  160. ZBIOS    INC      6273 31.12.91   14:35     | sources
  161. ZSIM     EXE     15086 12.01.92   18:01     | ZSIM compressed with LZEXE
  162. SUPERDOS SYS      8704 14.01.92   20:56     | CP/M compatible Dos
  163. Z80DOS   SYS      8704 14.01.92   20:57     | CP/M compatible Dos
  164. 8080EMU  OBJ      8304 12.01.92   16:34     | 8080 Emulator objects
  165. Z80EMU   OBJ     23623 12.01.92   16:34     | Z80 Emulator objects
  166. EMUMENU  OBJ      8591 12.01.92   16:42     | Modula2 objects
  167. EMUMENU  DEF      1737 12.01.92   16:41     | Modula2 sources
  168. EMUMENU  MOD     17215 12.01.92   16:41     | Modula2 sources
  169. CPMSYS   CPM      8704 11.01.92   23:28     | system image to boot from
  170. RAMDISC  CPM    385026 12.01.92   17:31     | a sample ramdisc
  171. CPMFRM   EXE     18144 06.10.90    0:37     | format CP/M disks
  172. CPMFRM   MOD      3579 06.10.90    0:36     | its sources
  173. CHANGES  JGW      1023 12.01.92   13:03     | changes in Z80DOS+ZCPR
  174. OSBOURN  PAR        22 16.12.91   10:41     | Discparm Osbourn DD
  175. ZSIM     DOC     28983 12.01.92   18:28     | docs english
  176. ZSIMGER  DOC     34234 12.01.92   18:07     | docs german
  177. READ     ME                                 | the file you're reading
  178.  
  179.  
  180. In RAMDISC.CPM is a sample ramdisc that contains Ron Cain's Small C
  181. Compiler, the VDE editor and the PPIP file copy program.
  182. 8080EMU.OBJ contains a version of the cpu emulator that understands
  183. only 8080 code but runs a bit faster as it needn't worry about some
  184. of the Z80's intricacies.
  185. If you want to use Z80DOS instead of SUPERDOS simply copy Z80DOS.SYS
  186. to CPMSYS.CPM.
  187.  
  188. I got SUPERDOS, Z80DOS and ZCPR from the SIMTEL20 [192.88.110.20] ftp
  189. server (directory PD2:<CPM.xxx> xxx=BDOS,ZCPR). It contains a lot of
  190. other CP/M software too.
  191.  
  192.  
  193. HAVE FUN using ZSIM!
  194.  
  195. JÅrgen G. Weber
  196.